<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<HTML>
  <HEAD>

    <TITLE>Search Results Window</TITLE>
    <LINK rel="stylesheet" type="text/css" href="help/shared/DefaultStyle.css">
  </HEAD>

  <BODY>
    <H1><A name="Query_Results"></A> Search Results Window</H1>

    <P>The <I>Search Results</I> window displays search results from various sources (plugins). The
    window is useful for navigating to a resultant location or selecting some number of result
    locations for another operation that requires a selection. The information displayed in each
    column may differ depending on the search operation that populated the window. However, the
    window's capabilities are the same. The image below shows the results of a search. You will
    also see the <I>Search Results</I> window when you do a <A href=
    "help/topics/Navigation/Navigation.htm#Go_To_Address_Label">Go To</A> for matching a wildcard
    entry.</P>

    <CENTER>
      <TABLE border="0" width="100%">
        <TBODY>
          <TR>
            <TD width="100%" align="center"><IMG border="0" src="images/QueryResultsSearch.png" alt=""></TD>
          </TR>
        </TBODY>
      </TABLE>
    </CENTER>

    <BLOCKQUOTE>
      <P>Each row of the table is associated with an address or location within the program. There
      may be multiple entries for the same address, depending on the type of search. For example,
      when searching text, a string may appear multiple times in the same pre-comment. So, you will
      see an entry for each in the Search Results window. The title bar shows the number of entries
      being displayed.</P>

      <P>The tool has an option for the maximum number of search results. The search will stop after
      this number has been exceeded. To see more search results, 
      <A href="help/topics/Search/Search_Program_Text.htm#SearchLimit">increase your search
      limit</A>.</P>
    </BLOCKQUOTE>

    <H3><A NAME="Navigation">Navigation</H3>

    <BLOCKQUOTE>
      <P>As with most tables in Ghidra, you may change the location of the cursor within the tool
      by clicking on the various table cells. The location to which the cursor is moved depends
      upon which table cell is clicked. For example, clicking on the location column will move the
      cursor to the location where the match was found. Alternatively, clicking on a label in the
      label column will move the cursor to the corresponding label in the listing panel.</P>
    </BLOCKQUOTE>

    <H3>Marker Margins</H3>

    <BLOCKQUOTE>
      <P>When searching strings or memory, a yellow arrow marker <IMG border="0" src=
      "images/searchm_obj.gif" "> is placed in the left hand marker margin at
      each location in the browser that a match was found. The location of each search result in the
      entire view is displayed as a yellow box in the right hand Navigation Margin. You can
      navigate to a search result by left-mouse-clicking on the yellow box in the Navigation margin.
      The Navigation margin provides a general overview of where in the program any search results
      were found.</P>
    </BLOCKQUOTE>

    <H3>Renaming Windows</H3>

    <BLOCKQUOTE>
      <IMG border="0" src="help/shared/tip.png" alt="">
      <P><I>see <A HREF="help/topics/DockingWindows/Docking_Windows.htm#Renaming_Windows">
      Docking Windows - Renaming Windows</A></I></P>
    </BLOCKQUOTE>


	<H2>Actions</H2>
	
	<BLOCKQUOTE>


	    <H3><A name="Make_Selection"></A>Make Selection <IMG border="0" src="Icons.MAKE_SELECTION_ICON"></H3>
	
	    <BLOCKQUOTE>
	      <P>A selection in the Listing can be created from the entries in the results table. 
	      The selection can also be used as input to another operation that uses
	      the current selection, e.g., a follow-on search that is restricted to the results of the
	      first search using the current selection.</P>
	
	      <BLOCKQUOTE>
	        <P>To create a selection from all the result items,</P>
	
	        <OL>
	          <LI>Click in the results table and press <TT><B>Ctrl+A</B></TT>.</LI>
	
	          <LI>Click on the <IMG border="0" src="Icons.MAKE_SELECTION_ICON" > in
	          the tool bar, or right mouse click and choose <B>Make Selection</B>.</LI>
	
	          <LI>The current selection will be set to the address of each result item.</LI>
	        </OL>
	
	        <P>To create a selection from a subset of the items,</P>
	
	        <OL>
	          <LI>Select the result items with the <TT><B>Ctrl+left-mouse</B></TT> or
	          <TT><B>Shift+left-mouse</B></TT>.</LI>
	
	          <LI>Press and hold the right mouse button over the results table.</LI>
	
	          <LI>Click on the <IMG border="0" src="Icons.MAKE_SELECTION_ICON" > in
	          the tool bar, or right mouse click and choose <B>Make Selection</B>.</LI>
	
	          <LI>The current selection will be set to the address of all the highlighted items.</LI>
	        </OL>
	      </BLOCKQUOTE>
	    </BLOCKQUOTE>
	
		
	    <H3><A name="Remove_Items"></A>Remove Items <IMG border="0" src="images/table_delete.png"></H3>
	
	    <BLOCKQUOTE>
	      <P>You can remove entries from the table via this action.  Items are <b>only</b> removed
	      from the table--no program data is changed.  This can be useful when you wish to 
	      exclude results that are of no interest to you.</P>
	    </BLOCKQUOTE>
	
	
	    <H3><A name="Selection_Navigation"></A>Selection Navigation <IMG border="0" src=
	    "images/locationIn.gif" alt=""></H3>
	
	    <BLOCKQUOTE>
	      <P>This action causes the Listing to navigate to the address represented by a row when
	      that row is selected. Toggling this action on allows you to use the up and down arrow keys to
	      change the selection in the table while also navigating to that address in the Listing.
	      You may also use this action to trigger navigation when single-clicking a table row.<BR>
	      <BR>
	      </P>
	    </BLOCKQUOTE>

    
    </BLOCKQUOTE>
    

    <P class="relatedtopic">Related Topics:</P>

    <BLOCKQUOTE>
      <UL>
        <LI>
          <A href="help/topics/Tool/ToolOptions_Dialog.htm">Tool
          Options</A>
        </LI>
        <LI>
          <A href="Search_Program_Text.htm">Text Search</A>
        </LI>
        <LI>
          <A href="help/topics/Navigation/Navigation.htm#Go_To_Address_Label">Go To</A>
        </LI>
      </UL>
    </BLOCKQUOTE>
    
        <BR>
    <BR>
    <BR>
  </BODY>
</HTML>
